home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 26.zip / BS1 part 26 / Maverick v4.01.adf / RequesterLibrary / READ.ME next >
Text File  |  1992-03-06  |  3KB  |  50 lines
  1. =============================================================================
  2.         "REQUESTOR LIBRARY IS FREEWARE."
  3.     
  4.         K.J.P.B. is including this archive to satisfy the legal
  5.     requirements for commercial use of "req.library". We have used
  6.     the routines in this library frequently and found them highly
  7.     useful.
  8.         Kudos to the authors!
  9.                     Bob Mills
  10.                     March 25, 1991
  11. =============================================================================
  12. Official release of version 1.2, October '89.
  13. Req.library  is Copyright (c)1989, 1990 by C.W.  Fox and Bruce Dawson.  It is
  14. freely  distributable.  No charge may be made for it's distribution, except
  15. for a nominal media fee.
  16.      Feel free to distribute and use this library with your programs, along
  17. with a notice that the library is 'FreeWare'.
  18. =============================================================================
  19.     Hello! This is the introduction to the all-new "req.library"!
  20.     What is it?
  21.     Req.library  adds  user-friendliness  to  the  Amiga's  user interface.
  22. While  Intuition  does supply requesters, they have certain limitations and
  23. are awkward to set up.  We designed ours to be quick and easy to set up, as
  24. well  as  adding  features.  The text requester has PRINTF style formatting
  25. built  in!   There is a colour requester, a very powerful file requester, a
  26. string  requester  (allowing  the  user  to  enter  a line of text), and an
  27. integer  requester  (allowing  the user to enter an integer number).  There
  28. are  also low-level support routines, such as routines to create any of the
  29. Amiga's gadgets, as well as a real-time scroll routine.
  30.     The  nice  thing about the gadget creation routines, is that they allow
  31. you to create gadgets from parameters, meaning that you can allocate memory
  32. and have your gadgets constructed there.  This allows you to use gadgets in
  33. code  that  is  meant to be re-entrant.  This normally wouldn't be possible
  34. with gadgets.  The size necessary for each gadget has been defined, and you
  35. will find the definitions in reqbase.i and reqbase.h.
  36.     (Please see req.doc for a more comprehensive explanation).
  37.   Here is an overview of the files included in this archive:
  38.     reqbase.h             The C include file. Put it in include/libraries
  39.     reqbase.i             The asm include file. Put it in include/libraries
  40.     req.library           The actual library. This goes in libs:
  41.     req.doc               The instructions and calling conventions.
  42.     read.me               This file
  43. -----------------------------------------------------------------------------
  44.     The library is EXACTLY like system libraries; you open
  45. it, call functions, and then close it. All you have to include to actually use
  46. the req.library is reqbase.i.  This contains all the function offsets.  You
  47. may  wish  to call the functions directly, or use a bit of gluecode to make
  48. things even easier.  If you wish to do it all yourself, then all you've got
  49. to  do  is  include  reqbase.i.
  50.